Saltar al contenido principal

Mover un archivo o directorio (file.move)

Declaración​

éxito, mensaje_de_error = file.move(ruta_de_origen, ruta_de_destino [, modo])

Parámetros​

  • ruta_de_origen
    Texto; ruta absoluta del archivo o directorio de origen.
  • ruta_de_destino
    Texto; ruta absoluta completa del archivo o directorio tras el movimiento, incluido el nombre del archivo o directorio de destino.
  • modo 20250914+
    Texto opcional, modo de movimiento:
    • cadena vacía u omitido: modo predeterminado (no-clobber); falla si el destino existe
    • "overwrite" o "o": reemplaza directamente el destino existente (el destino existente se elimina)
    • "merge" o "m": modo de fusión (solo para directorios); conserva los archivos que ya existen en el destino
    • "overwrite-merge" u "om"/"mo": fusiona directorios y reemplaza archivos con el mismo nombre

Valores devueltos​

  • éxito
    Booleano; devuelve true si tiene éxito y false si falla.
  • mensaje_de_error
    Texto; mensaje de error cuando la operación falla.

Descripción​

Mueve el archivo o directorio indicado por ruta_de_origen a la ruta exacta ruta_de_destino; cambiar el nombre dentro del mismo directorio equivale a renombrarlo.
Esta función significa «mover como», no «mover dentro de». ruta_de_destino especifica el archivo o directorio final; no se añade automáticamente el nombre del archivo o directorio de origen. Aunque el destino ya exista y sea un directorio, o su ruta termine en /, la fuente no se colocará dentro de ese directorio.
Por ejemplo, para mover /a/b/c dentro de /d/e/ conservando el nombre c, la ruta de destino debe ser /d/e/c, no solo /d/e/.
Si el destino ya existe, se aplica el parámetro modo: el modo predeterminado falla, el modo de sobrescritura reemplaza el propio destino y los modos de fusión de directorios fusionan el contenido del directorio de origen con el directorio de destino.
Palabras clave: renombrar o mover archivos, directorios y carpetas.
Disponible desde las versiones posteriores a 20250313.

Ejemplo​

ok, err = file.move(XXT_SCRIPTS_PATH..'/1.zip', XXT_SCRIPTS_PATH..'/2.zip')
if not ok then
sys.alert('Error al mover: '..err)
end

Nota: el código anterior usa la función de otro capítulo sys.alert.

Mover a otro directorio conservando el nombre​

-- Supongamos que /d/e es un directorio existente y que /d/e/c aún no existe
file.move('/a/b/c', '/d/e/c') -- Correcto: mover c a /d/e/c

-- Ejemplo incorrecto independiente: el destino es e, no c dentro del directorio e
-- file.move('/a/b/c', '/d/e/') -- Falla en el modo predeterminado porque el destino ya existe

-- El modo de sobrescritura reemplaza e y no crea /d/e/c (20250914+)
-- file.move('/a/b/c', '/d/e/', 'overwrite')

Definir una función para mover dentro de un directorio​

El siguiente ejemplo define una función auxiliar personalizada y requiere una versión posterior a 20250914. El directorio de destino debe existir. La función conserva el nombre del archivo o directorio de origen y pasa el parámetro opcional mode a file.move. Los conflictos de nombres se siguen resolviendo según el modo indicado.

local function file_move_into(src_path, dst_dir, mode)
if file.exists(dst_dir) ~= "directory" then
return false, "Target is not a directory"
end

local name, err = file.path.last_component(src_path)
if not name then
return false, err
end
-- Evita usar el propio directorio de destino o su directorio padre como destino final.
if name == "" or name == "/" or name == "." or name == ".." then
return false, "Source path must end with a file or directory name"
end

local dst_path, path_err = file.path.add_component(dst_dir, name)
if not dst_path then
return false, path_err
end
return file.move(src_path, dst_path, mode)
end

-- Supongamos que /d/e es un directorio existente; mover c a /d/e/c
local ok, err = file_move_into("/a/b/c", "/d/e/")
if not ok then
print("Error al mover: "..err)
end

-- Para reemplazar /d/e/c, indique el modo de sobrescritura al llamar a la función:
-- file_move_into("/a/b/c", "/d/e/", "overwrite")

Nota: el código anterior usa file.exists, file.path.last_component y file.path.add_component.